package com.skilltrack.user.service.impl;

import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.skilltrack.user.mapper.DictionaryMapper;
import com.skilltrack.user.model.po.Dictionary;
import com.skilltrack.user.service.DictionaryService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;

import java.util.List;

/**
 * <p>
 * 数据字典 服务实现类
 * </p>
 *
 * @author itcast
 */
@Slf4j
@Service
public class DictionaryServiceImpl extends ServiceImpl<DictionaryMapper, Dictionary> implements DictionaryService {

    /**
     * 查询所有字典项
     *
     * 此方法用于获取数据库中所有的字典项，并将其作为一个列表返回
     * 它没有输入参数，也不抛出任何异常
     *
     * @return List<Dictionary> 包含所有字典项的列表
     */
    @Override
    public List<Dictionary> queryAll() {

        // 获取所有字典项的列表
        List<Dictionary> list = this.list();

        // 返回包含所有字典项的列表
        return list;
    }

    /**
     * 根据代码获取字典对象
     *
     * 此方法用于通过特定代码查询并返回对应的字典对象它主要用于字典数据的快速检索，
     * 以便在其他部分代码中可以根据代码直接获取到字典的详细信息
     *
     * @param code 字典的代码，这是查询字典对象的唯一标识和依据
     * @return 返回查询到的字典对象如果找不到匹配的字典，则返回null
     */
    @Override
    public Dictionary getByCode(String code) {

        // 创建LambdaQueryWrapper对象，用于构建查询条件
        LambdaQueryWrapper<Dictionary> queryWrapper = new LambdaQueryWrapper<>();
        // 设置查询条件为字典的代码等于传入的code参数
        queryWrapper.eq(Dictionary::getCode, code);

        // 调用getOne方法执行查询，获取满足条件的单个字典对象
        Dictionary dictionary = this.getOne(queryWrapper);

        // 返回查询到的字典对象
        return dictionary;
    }
}
